Summary

• agentex agents run unconditionally sets REDIS_URL=redis://localhost:6379 in the agent process env. Combined with the module-level RedisStreamRepository from from agentex.lib import adk, agents that don't actually use adk.messages/adk.streaming see silent request hangs when no local Redis is reachable (e.g. Temporal-direct async agents running in restricted dev pods). The lazy redis.asyncio client only fails on first publish, so there's no startup error to surface.
• Add an explicit local_development.redis_enabled: bool = true (default) flag on the agent manifest. Default preserves existing behavior; users with no local Redis can set false to opt out of the REDIS_URL default.
• acp_type is not a reliable discriminator: examples/tutorials/10_async/00_base/110_pydantic_ai and 100_langgraph are acp_type: async and legitimately call adk.messages.create(...); several acp_type: sync tutorials also use adk.messages. Hence the explicit per-manifest opt-out instead of an acp_type-based rule.

Files

• src/agentex/lib/sdk/config/local_development_config.py — new redis_enabled: bool = True field on LocalDevelopmentConfig.
• src/agentex/lib/cli/handlers/run_handlers.py — create_agent_environment skips the REDIS_URL default when local_development.redis_enabled is false.

Example manifest opt-out

local_development:
  agent:
    port: 8000
  redis_enabled: false

Test plan

• rye run pyright on modified files — 0 errors.
• rye run ruff check on modified files — clean.
• Manual round-trip: default → REDIS_URL set; redis_enabled: false → REDIS_URL absent (verified against examples/tutorials/10_async/00_base/110_pydantic_ai/manifest.yaml).
• Related test (tests/... matching local_development|run_handlers|manifest) passes.
• Reviewer: confirm default-true is the right backwards-compat call vs. inverting to default-false.

Linear

MAY-1086

🤖 Generated with Claude Code

Greptile Summary

This PR adds a local_development.redis_enabled: bool = True field to LocalDevelopmentConfig and gates the automatic REDIS_URL=redis://localhost:6379 injection in create_agent_environment on that flag. The fix addresses silent request hangs in dev pods where no local Redis is reachable.

• local_development_config.py: Adds redis_enabled field with default=True to preserve existing behavior; agents that don't use adk.messages/adk.streaming can set it to false.
• run_handlers.py: The conditional now sets REDIS_URL in env_vars when opted in, and actively pops any inherited parent-shell REDIS_URL when opted out — ensuring the opt-out is clean even when the shell exports the variable.
• test_run_handlers.py: Three parametric scenarios cover the default, opt-out-clean, and opt-out-with-stale-parent-env cases.

Important Files Changed

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[create_agent_environment] --> B["env = dict(os.environ)"]
    B --> C["Build env_vars: TEMPORAL_ADDRESS, AGENT_NAME, ACP_TYPE, ACP_URL, ACP_PORT"]
    C --> D{"manifest.local_development.redis_enabled?"}
    D -- "True (default)" --> E["env_vars['REDIS_URL'] = 'redis://localhost:6379'"]
    D -- "False" --> F["env.pop('REDIS_URL', None)"]
    E --> G["Apply agent_config.env overrides to env_vars"]
    F --> G
    G --> H["env.update(env_vars)"]
    H --> I["return env"]

_{Reviews (3): Last reviewed commit: "test(cli): decouple run_handlers tests f..." | Re-trigger Greptile}